home *** CD-ROM | disk | FTP | other *** search
/ Visual Basic Controls / Visual Basic Controls.iso / vbcontrol / freesize / freesize.txt < prev   
Encoding:
Text File  |  1999-05-13  |  5.8 KB  |  133 lines
  1.                            .----------------------.
  2.                            |                      |
  3.                            | freeSize OCX v1.00▀2 |
  4.                            |                      |
  5.                            `----------------------'
  6.  
  7. INTRODUCTION
  8.  
  9. For the longest time I searched for a freeware control that could handle my
  10. simple needs for form/control resizing.  Every possible lead that I found
  11. resulted in a dead end.  One day, my new issue of VBPJ (Visual Basic
  12. Programmer's Journal) had a cover article entitled "RESIZE FORMS at Run Time"
  13. (by Francesco Balena) and this made me very excited.  I decided my only option
  14. was to take the wonderful information in this issue (July, 1998) and use it to
  15. my (and everyone else's) advantage.  I took the ideas and framework provided by
  16. Mr. Balena and enhanced it with a few added features and bug-fixes.  I plan to
  17. keep improving this control as long as I get new ideas and feedback from other
  18. programmers.  So, I have decided to release this revamped VBPJ treasure to
  19. the public as the freeware control that I was so desperately searching for.
  20. This control is also royalty free.
  21.  
  22. PURPOSE
  23.  
  24. The purpose of freeSize is to offer your programs a way to retain their
  25. pleasant cosmetic look.  I found myself many times changing my form's BorderStyle
  26. to 'fixed dialog' so the user couldn't resize the form.  Sometimes this is okay,
  27. but other times it just won't work due to the nature of the program.
  28.  
  29. USAGE
  30.  
  31. To use freeSize, simply put the control on your form and set its properties
  32. to your desired value.
  33.  
  34. PROPERTIES
  35.  
  36. MinFormHeight
  37.     The MinFormHeight property is a value at which you want the form's
  38.     height property to be at a minimum.  This will prevent the user from
  39.     making your form too small.  When set to 0, this feature is disabled.
  40.  
  41. MinFormWidth
  42.         The MinFormWidth property is a value at which you want the form's
  43.         width property to be at a minimum.  This will prevent the user from
  44.         making your form too small.  When set to 0, this feature is disabled.
  45.  
  46. MaxFormHeight
  47.     The ManFormHeight property is a value at which you want the form's
  48.     height property to be at a maximum.  This will prevent the user from
  49.     making your form too big.  When set to 0, this feature is disabled.
  50.  
  51. MaxFormWidth
  52.         The MaxFormWidth property is a value at which you want the form's
  53.         width property to be at a maximum.  This will prevent the user from
  54.         making your form too big.  When set to 0, this feature is disabled.
  55.  
  56. MoveObjects
  57.         The MoveObjects property, when set to true, will move the controls on
  58.         your form to keep their position in the same ratio as they were at
  59.         load-time.
  60.  
  61. ResizeObjects
  62.     The ResizeObjects property, when set to true, will change the size of the
  63.     controls on your form to keep their size in ratio with the form's new size.
  64.  
  65. ResizeFonts
  66.         The ResizeFonts property, when set to true, will change the font
  67.         size for any controls with text so that the text reflects the ratio
  68.         of change in form size.
  69.  
  70. OTHER OPTIONS
  71.  
  72. If you want any certain control to be exempt from the changes made by
  73. freeSize, then simply set that control's "Tag" property to "no".  The
  74. Tag property is basically just a property that VB doesn't use and it is
  75. only there to hold additional information your program might use.
  76.  
  77. LET DOWNS
  78.  
  79. There is really only one thing that I wish was a bit more refined.  The
  80. properties that restrict form height and width are designed in a rather simple
  81. way.  Because of their simplicity, I am not totally pleased with their
  82. functionality.  The problem is that when the form is resized to an 'invalid'
  83. size, the form's size will jump back and forth because freeSize and the OS are,
  84. in theory, "fighting" for control of the form's dimensions.  I have had some code
  85. e-mailed to me on this issue.  I am still attempting to iron it all out so it
  86. will work within an OCX, but things should hopefully be all set for the next
  87. release.
  88.  
  89. FINAL REQUEST
  90.  
  91. As the author of this control, I ask you to only do one simple thing:
  92. E-MAIL ME!!  I greatly want to hear about your experiences with my control and
  93. any improvements/changes you would like to see.  This control is provided for
  94. you, and if you don't tell me how you want it, there is no way it will get to
  95. be how you want it.  So, e-mail me with all comments/questions/critiques.
  96.  
  97. Thank you for reading this far :)
  98.  
  99. -- Shaun McPeck (shaun.mcpeck@wmich.edu)
  100.  
  101.  
  102. Release history:
  103. (-) Bug
  104. (+) Addition
  105. (*) Fix
  106.  
  107. 02/09/99    v1.00 beta
  108.  
  109.     (-)    Run-Time Error when KeepRatio = TRUE and the form is maximized.
  110.     (-)    When KeepRatio = TRUE, resizing does not work properly.
  111.  
  112. 05/13/99    v1.00 beta2
  113.  
  114.     (*)    Not sure if this is really a "fix" :)  But the KeepRatio property
  115.         was removed due to the problems it caused.  If anyone really wants
  116.         this property reimplemented, please let me know and I will work
  117.         on it.  Otherwise, don't look for KeepRatio anytime in the near
  118.         future.
  119.     (+)    freeSize now sports its own icon.  (Thanks, ??????!!)
  120.     (+)    ResizeObjects property added to give more control over freeSize.
  121.  
  122. Future Ideas:
  123.  
  124. In the next release, expect for freeSize to be smart and have a read-only
  125. property called CtrlList or something similar.  This will have a list of all
  126. controls on your form and you will be able to select a KeepRatio, ResizeFont,
  127. MoveControl, etc, etc, etc for each control on your form.  This will give you
  128. a lot more flexibility as to how freeSize acts on different controls.
  129.  
  130. I also intend to have freeSize position and size your form at load-time so
  131. the form will be in a nice position on the screen and also have a reasonable
  132. size.  This will solve the problem of running a program developed in 1024x768
  133. mode on a machine that is in 800x600 mode.